Esta página lista os relatórios que os proprietários de conteúdo podem recuperar com a API YouTube Reporting. O id de cada relatório, retornado pelo método reportTypes.list da API, é mostrado entre parênteses ao lado do nome do relatório.
Relatórios de vídeo
Os relatórios de vídeo mostram estatísticas de todas as atividades dos usuários relacionadas aos vídeos de um canal ou de um proprietário de conteúdo. Por exemplo, esses relatórios contêm o número de vezes que seus vídeos foram visualizados.
Atividade do usuário
Este relatório mostra as estatísticas de atividade do usuário relacionadas aos canais e vídeos de um proprietário de conteúdo. O id da versão atual deste relatório é content_owner_basic_a3.
O id para esta versão do relatório é content_owner_basic_a3. Ela tem as seguintes diferenças em relação à versão a2:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Atividade do usuário por província
Neste relatório, são exibidas as estatísticas da atividade do usuário para estados nos EUA e para o Distrito de Columbia. O id deste relatório é content_owner_province_a2.
O id para esta versão do relatório é content_owner_province_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Locais de reprodução
Neste relatório, são exibidas as estatísticas relacionadas ao tipo de página ou aplicativo em que ocorreram as reproduções do vídeo. O id deste relatório é content_owner_playback_location_a2.
O id para esta versão do relatório é content_owner_playback_location_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Origens de tráfego
Esse relatório agrega as estatísticas de visualização com base na forma como os espectadores alcançaram os vídeos nos canais do proprietário do conteúdo.
Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id deste relatório é content_owner_traffic_source_a2.
O id para esta versão do relatório é content_owner_traffic_source_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Tipo de dispositivo e sistema operacional
Esse relatório agrega estatísticas de visualização de vídeos com base nos sistemas operacionais e tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id deste relatório é content_owner_device_os_a2.
O id para esta versão do relatório é content_owner_device_os_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Informações demográficas do espectador
Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores.
O id deste relatório é content_owner_demographics_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
| Métricas: | views_percentage |
Compartilhamento de conteúdo por plataforma
Esse relatório mostra estatísticas sobre a frequência com que os vídeos nos canais do proprietário do conteúdo foram compartilhados em diferentes plataformas sociais.
O id deste relatório é content_owner_sharing_service_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | ações |
Anotações
Esse relatório mostra estatísticas das anotações exibidas durante os vídeos nos canais de um proprietário de conteúdo.
Os dados do relatório medem a performance de anotações individuais para cada vídeo. Já o Relatório de atividade do usuário agrega estatísticas de todas as anotações de um vídeo.
O id deste relatório é content_owner_annotations_a1.
Cartões
Esse relatório mostra as impressões e as estatísticas de cliques dos cards exibidos durante os vídeos nos canais de um proprietário de conteúdo.
Os dados do relatório medem a performance de cards individuais. Já o Relatório de atividade do usuário agrega estatísticas de todos os cards de um vídeo.
O id deste relatório é content_owner_cards_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
| Métricas: | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Telas finais
Esse relatório mostra as estatísticas de impressões e de cliques para telas finais que aparecem depois que um vídeo para de ser reproduzido.
O relatório contém estatísticas de vídeos nos canais de um proprietário de conteúdo.
O id deste relatório é content_owner_end_screens_a1.
Legendas
Esse relatório mostra estatísticas sobre o idioma das legendas usadas por mais tempo durante as visualizações de vídeo. As visualizações em que as legendas estão desativadas são excluídas. O id deste relatório é content_owner_subtitles_a2.
O id para esta versão do relatório é content_owner_subtitles_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Combinado
Esse relatório fornece estatísticas detalhadas de vídeo combinando as dimensões usadas nos relatórios local de reprodução, origem do tráfego e dispositivo/SO. O id deste relatório é content_owner_combined_a2.
O id para esta versão do relatório é content_owner_combined_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Relatórios de playlists
Os relatórios de playlist mostram estatísticas relacionadas especificamente às visualizações de vídeo que ocorrem no contexto de uma playlist.
Atividade do usuário
Esse relatório mostra estatísticas relacionadas às interações dos usuários com as playlists nos canais de um proprietário de conteúdo.
O id deste relatório é content_owner_playlist_basic_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
| Métricas: | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Atividade do usuário por província
Este relatório mostra as estatísticas de atividade do usuário relacionadas às interações com playlists nos canais de um proprietário de conteúdo para usuários nos estados dos EUA e no Distrito de Columbia.
Isso significa que o relatório é filtrado para incluir apenas dados se o valor da dimensão country_code for US. O id deste relatório é content_owner_playlist_province_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
| Métricas: | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Locais de reprodução
Esse relatório mostra estatísticas relacionadas ao tipo de página ou aplicativo em que as reproduções de playlist ocorreram. O id deste relatório é content_owner_playlist_playback_location_a1.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores acessaram vídeos de playlists nos canais de um proprietário de conteúdo.
Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id deste relatório é content_owner_playlist_traffic_source_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
| Métricas: | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Tipo de dispositivo e sistema operacional
Esse relatório agrega as estatísticas de visualização de playlists com base nos sistemas operacionais e nos tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id deste relatório é content_owner_playlist_device_os_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
| Métricas: | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Combinado
Esse relatório fornece estatísticas detalhadas da playlist combinando as dimensões usadas nos relatórios de local de reprodução, origem do tráfego e dispositivo/SO. O id deste relatório é content_owner_playlist_combined_a1.
Relatórios de taxa de anúncios
Os relatórios de taxa de anúncios fornecem métricas baseadas em impressões para anúncios veiculados durante a reprodução de vídeos. Essas métricas representam cada impressão de anúncio, e cada reprodução de vídeo pode gerar várias impressões.
A API oferece suporte ao seguinte relatório de taxas de anúncios, que fornece métricas de taxa de anúncios para os vídeos de um proprietário de conteúdo. O id da versão atual deste relatório é content_owner_ad_rates_a1.
O id para esta versão do relatório é content_owner_ad_rates_a1. O ID da versão anterior deste relatório, que agora está totalmente descontinuado, era content_owner_ad_performance_a1.
A única diferença em relação à versão anterior é que esta versão atualiza o nome do relatório para usar a palavra rates em vez de performance. Como resultado, o relatório tem o mesmo número de versão (a1) da versão anterior, mas o report ID é diferente.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, country_code, ad_type |
| Métricas: | estimated_youtube_ad_revenue, ad_impressions, estimated_cpm |
Relatórios de receita estimada
Os relatórios de receita estimada mostram o valor total estimado para vídeos de origens de publicidade e não publicitárias vendidas pelo Google. Esses relatórios também contêm algumas métricas de performance do anúncio.
As métricas de ganhos identificam fontes de receita específicas e o valor da receita total acumulada por esses fluxos.
Receita de vídeo estimada
Este relatório mostra os ganhos totais de todos os vídeos de um proprietário de conteúdo de origens de publicidade vendidas pelo Google e de origens não relacionadas a publicidade. Ele também contém algumas métricas de performance de anúncios. O id da versão atual deste relatório é content_owner_estimated_revenue_a1.
O id para esta versão do relatório é content_owner_estimated_revenue_a1. Ela tem as seguintes diferenças em relação à versão anterior, que era content_owner_estimated_earnings_a1:
- Adiciona a métrica estimated_partner_red_revenue
- Adiciona a métrica estimated_partner_transaction_revenue
- Renomeia a métrica estimated_partner_ad_sense_revenue para estimated_partner_ad_auction_revenue
- Renomeia a métrica estimated_partner_double_click_revenue para estimated_partner_ad_reserved_revenue
- Atualiza o nome do relatório para usar a palavra
revenueem vez deearnings. Como resultado, o relatório tem o mesmo número de versão (a1) da versão anterior, mas oreport IDé diferente.
Receita de recursos estimada
Esse relatório mostra os ganhos totais de todos os recursos de um proprietário de conteúdo de origens de publicidade vendidas pelo Google e de origens não relacionadas a publicidade. Ele também contém algumas métricas de performance de anúncios. A dimensão channel_id identifica o canal que enviou o video_id para o qual as métricas estão sendo fornecidas. O id da versão atual deste relatório é content_owner_asset_estimated_revenue_a1.
O id para esta versão do relatório é content_owner_asset_estimated_revenue_a1. Ela tem as seguintes diferenças em relação à versão anterior, que era content_owner_asset_estimated_earnings_a1:
- Adiciona a métrica estimated_partner_red_revenue
- Adiciona a métrica estimated_partner_transaction_revenue
- Renomeia a métrica estimated_partner_ad_sense_revenue para estimated_partner_ad_auction_revenue
- Renomeia a métrica estimated_partner_double_click_revenue para estimated_partner_ad_reserved_revenue
- Atualiza o nome do relatório para usar a palavra
revenueem vez deearnings. Como resultado, o relatório tem o mesmo número de versão (a1) da versão anterior, mas oreport IDé diferente.
Relatórios de recursos
Os relatórios de recursos mostram métricas de atividade do usuário relacionadas a vídeos vinculados aos recursos de um proprietário de conteúdo. Um vídeo é incluído no relatório de um proprietário de conteúdo se ele tiver reivindicado o conteúdo como correspondente a um dos recursos do proprietário. O vídeo pode ter sido enviado pelo proprietário do conteúdo ou por outro usuário do YouTube.
Nos relatórios de recursos, a dimensão channel_id identifica o canal que enviou o video_id para as métricas.
Por exemplo, em um dia específico, suponha que um vídeo seja visualizado 10 vezes, reivindicado e visualizado mais 10 vezes. O relatório de recursos daquele dia vai mostrar que o vídeo foi visualizado 20 vezes, mesmo que apenas 10 dessas visualizações tenham ocorrido após a reivindicação. As métricas de todos os dias sucessivos precisam refletir com precisão a atividade do usuário relacionada ao vídeo reivindicado.
Atividade do usuário
Esse relatório mostra estatísticas relacionadas às ações dos usuários em vídeos vinculados aos recursos de um proprietário de conteúdo. O id deste relatório é content_owner_asset_basic_a2.
O id para esta versão do relatório é content_owner_asset_basic_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Atividade do usuário por província
Neste relatório, são exibidas as estatísticas da atividade do usuário para estados nos EUA e para o Distrito de Columbia. Isso significa que o relatório é filtrado para incluir apenas dados se o valor da dimensão country_code for US. O id deste relatório é content_owner_asset_province_a2.
O id para esta versão do relatório é content_owner_asset_province_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Locais de reprodução do vídeo
Neste relatório, são exibidas as estatísticas relacionadas ao tipo de página ou aplicativo em que ocorreram as reproduções do vídeo. O id deste relatório é content_owner_asset_playback_location_a2.
O id para esta versão do relatório é content_owner_asset_playback_location_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores acessaram o conteúdo de vídeo vinculado aos recursos de um proprietário de conteúdo. Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id deste relatório é content_owner_asset_traffic_source_a2.
O id para esta versão do relatório é content_owner_asset_traffic_source_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Tipo de dispositivo e sistema operacional
Esse relatório agrega estatísticas de visualização de vídeos com base nos sistemas operacionais e tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id deste relatório é content_owner_asset_device_os_a2.
O id para esta versão do relatório é content_owner_asset_device_os_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes
Informações demográficas do espectador
Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores. O id deste relatório é content_owner_asset_demographics_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
| Métricas: | views_percentage |
Compartilhamento de conteúdo por plataforma
Esse relatório mostra estatísticas sobre a frequência com que os vídeos vinculados aos recursos de um proprietário do conteúdo foram compartilhados em diferentes plataformas sociais. O id deste relatório é content_owner_asset_sharing_service_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | ações |
Anotações
Esse relatório mostra estatísticas das anotações que aparecem durante os vídeos vinculados aos recursos de um proprietário de conteúdo. Os dados do relatório medem a performance de anotações individuais. Já o Relatório de atividade do usuário agrega estatísticas de todas as anotações de um vídeo. O id deste relatório é content_owner_asset_annotations_a1.
Cartões
Esse relatório mostra as impressões e as estatísticas de cliques dos cards exibidos durante os vídeos vinculados aos recursos de um proprietário de conteúdo. Os dados do relatório medem a performance de cards individuais. Já o Relatório de atividade do usuário agrega estatísticas de todos os cards que aparecem em cada vídeo vinculado a um recurso. O id deste relatório é content_owner_asset_cards_a1.
| Conteúdo | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
| Métricas: | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Telas finais
Esse relatório mostra as estatísticas de impressões e de cliques para telas finais que aparecem depois que um vídeo para de ser reproduzido. O relatório contém estatísticas de vídeos reivindicados nos canais de um proprietário do conteúdo e também identifica os recursos associados aos vídeos. O id deste relatório é content_owner_asset_end_screens_a1.
Combinado
Esse relatório fornece estatísticas detalhadas de vídeo combinando as dimensões usadas nos relatórios local de reprodução, origem do tráfego e dispositivo/SO. O id deste relatório é content_owner_asset_combined_a2.
O id para esta versão do relatório é content_owner_asset_combined_a2. Ela tem as seguintes diferenças em relação à versão a1:
- Adicionar a métrica red_views
- Adicionar a métrica red_watch_time_minutes